home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / twoutils.zip / DELETE.DOC < prev    next >
Text File  |  1989-10-14  |  5KB  |  100 lines

  1.                          DELETE - File Deletion Utility
  2.                         --------------------------------
  3.  
  4. Syntax:     DELETE <FILESPEC>
  5.  
  6. Options:    /ATTRIBUTES=<ATTRIBUTE-CODES>
  7.             /CONFIRM
  8.             /EXCLUDE=<FILESPEC>
  9.             /LOG
  10.             /VERSION
  11.             /ZAP
  12.  
  13. Remarks:    DELETE deletes the files matching the specified path. The path
  14.             may contain wild cards.  If the wild cards are full (either *
  15.             or *.*), a confirmation will be required before the deletion is
  16.             carried out, unless /NOCONFIRM is explicitly specified.
  17.  
  18.             The file specification is matched with files according to the
  19.             values specified with the /ATTRIBUTES and /EXCLUDE options.  If
  20.             a attribute list is given, only files with the specified
  21.             attributes will be included in the search.  If an /EXCLUDE
  22.             clause is given, the files matching the given specification will
  23.             be omited from the deletion.
  24.  
  25.             Files which are read-only will not be deleted.  If the /CONFIRM
  26.             option is specified, the read-only attribute will be indicated
  27.             and the file will be deleted should the user so request.
  28.  
  29.             If any wild card character is specified in the filename, a line
  30.             specifying the number of files deleted and their total size will
  31.             be displayed subsequent to the deletion.
  32.  
  33. Wild Cards: The wild card specification used with DELETE is different to that
  34.             used by DOS.  DOS does not match wild card specifications
  35.             correctly.  DELETE will match any wild card specification
  36.             exactly.  The following are examples:
  37.  
  38.                *s*           Matches any filename including an 'S' character.
  39.                ?*s*.tmp      Matches any file with type 'TMP' whose filename
  40.                              contains an 'S' after the first character.
  41.                *tmp*.*       Matches any file with 'TMP' in the name.
  42.                *.*           Matches any file with a name and extension.
  43.                *             Matches all filenames regardless of extension.
  44.  
  45.             Note the difference of '*' and '*.*'.  This implies that the
  46.             '.' character is treated exactly as any other character.
  47.  
  48.             DOS would fails with all of the first three examples, by matching
  49.             ALL filenames with the specifications given!  Dangerous!
  50.  
  51. Options:    /ATTRIBUTES=<ATTRIBUTE-CODES>
  52.             This option limits the search to the files with the matching
  53.             attributes.  The attributes are:
  54.  
  55.                   A   : Archive bit set (file changed since backup)
  56.                   H   : Hidden file (not seen by DOS)
  57.                   R   : Read-only
  58.                   S   : System file
  59.  
  60.             Files either System or Hidden will not normally be visible to
  61.             DELETE (as DOS), but by specifying the attributes explicitly
  62.             they become visible.
  63.  
  64.             /CONFIRM
  65.             Requests user confirmation of each file before deletion takes
  66.             place.  The filename is given, and the user must answer with
  67.             one of the following:
  68.  
  69.                   A   : ALL.  Delete this file and all subsequent ones
  70.                   N   : No.  Do not delete this file (default)
  71.                   Q   : Quit.  Stop now, files already deleted are gone.
  72.                   Y   : Yes.  Delete file normally.
  73.  
  74.             If a full wild card specification has been given (* or *.*)
  75.             without /CONFIRM, the message 'Are you sure?' will be displayed
  76.             for confirmation of the pending deletion.  If /CONFIRM is
  77.             specified this message will not be displayed as the files have
  78.             individual confirmation.  If /NOCONFIRM is explicitly given
  79.             the 'Are you sure?' message is supressed; the deletion going
  80.             ahead with no confirmation.
  81.  
  82.             /EXCLUDE=<FILESPEC>
  83.             Excludes matching files from the deletion.  Wild card matching
  84.             follows the rules indicated above under 'Wild Cards'.
  85.  
  86.             /LOG
  87.             Displays the filename and size of each file as it is deleted.
  88.             If /CONFIRM is specified the /LOG option will be ignored as
  89.             long as the user explicitly confirms the deletion.  If the 'A'
  90.             (All) option is used during confirmation, the /LOG option will
  91.             take effect for the remaining files.
  92.  
  93.             /VERSION
  94.             Displays the version number of the DELETE utility.
  95.  
  96.             /ZAP
  97.             Erases the file physically by clearing the old data.  This is a
  98.             security measure to ensure that a file may not be restored.  Use
  99.             with caution!
  100.